# 📖 SCSBasic - Simple Control System - Vehicle Control System -
## Complete Manual in English

---

## 📋 TABLE OF CONTENTS
1. [About the Mod](#about-the-mod)
2. [Requirements](#requirements)
3. [Installation](#installation)
4. [Recommended GTA V Configuration](#recommended-gta-v-configuration)
5. [Default Controls](#default-controls)
6. [Customization](#customization)
7. [Configuration Examples](#configuration-examples)
8. [Troubleshooting](#troubleshooting)
9. [Frequently Asked Questions](#frequently-asked-questions)

---

## 🎯 ABOUT THE MOD

**SCSBasic** is a manual vehicle control mod for GTA V that adds realistic controls for headlights, turn signals, hazard lights, engine, and windows.

### Key Features:
- ✅ **Native GTA V turn signal system** - Perfectly synchronized blinking
- ✅ **Complete lighting control** - Headlights, high beams, and hazard lights
- ✅ **Engine control** - Start/stop with starter sound
- ✅ **Window control** - Raise/lower front windows
- ✅ **Fully configurable** - Customize all keys via .ini file
- ✅ **Informative menu** - View status and controls in-game

---

## 💾 REQUIREMENTS

### Mandatory:
1. **Grand Theft Auto V** (updated version)
2. **ScriptHookV** - [Download here](http://www.dev-c.com/gtav/scripthookv/)
3. **ScriptHookVDotNet3** - [Download here](https://github.com/scripthookvdotnet/scripthookvdotnet-nightly/releases)

### Folder Structure:
```
Grand Theft Auto V/
├── ScriptHookV.dll
├── dinput8.dll
└── scripts/
    ├── ScriptHookVDotNet3.dll
    ├── SCSBasic.dll          ← This mod
    └── SCSBasic.ini          ← Configuration file
```

---

## 🔧 INSTALLATION

### Step 1: Prepare GTA V
1. Make sure **ScriptHookV** and **ScriptHookVDotNet3** are installed
2. Check if the `scripts` folder exists in `Grand Theft Auto V/`
3. If it doesn't exist, create the `scripts` folder

### Step 2: Install SCSBasic
1. Place **SCSBasic.dll** in the `scripts/` folder
2. Place **SCSBasic.ini** in the `scripts/` folder (same location as the DLL)

### Step 3: Verify Installation
1. Launch GTA V
2. You should see the message: **"SCSBasic loaded!"**
3. If you see **"Config file not found"**, verify the .ini is in the correct location

---

## ⚙️ RECOMMENDED GTA V CONFIGURATION

### 🎮 IMPORTANT: Rebind Game Keys

By default, GTA V uses **Q** and **E** for Radio and horn in vehicles.
Since SCSBasic uses these keys for turn signals, **it is highly recommended to rebind these game functions**.

### How to Rebind:

1. **Open GTA V settings menu**
2. **Go to: Settings → Controls**
3. **Find and change:**

   **E Key:**
   - **Recommendation:** Rebind to **MIDDLE MOUSE BUTTON** (scroll click)
   - Alternative: Any key of your preference (F, G, etc.)

   **Q Key (Radio station selector):**
   - **Recommendation:** Rebind to any key of your preference
   - Suggestions: ´, or any key you don't use frequently

### Why do this?

✅ **Avoids conflicts** - No duplicate keys  
✅ **More intuitive** - Q = left signal, E = right signal (like arrow keys)  
✅ **Mouse button is practical** and the feeling of pressing the horn is much more realistic.
✅ **Immersion** - Realistic vehicle controls without interference

---

## DEFAULT CONTROLS

### Lighting:
- **H** (press) → Toggle headlights on/off
- **H** (hold 2s) → Toggle hazard lights on/off
- **SHIFT + H** → Toggle high beams on/off

### Turn Signals:
- **Q** → LEFT signal ◄
- **E** → RIGHT signal ►

### Engine and Windows:
- **SHIFT + T** → Toggle engine on/off
- **SHIFT + Y** → Raise/lower front windows

### Menu:
- **SHIFT + I** → Open/close information menu

---

## 🛠️ CUSTOMIZATION

### Configuration File: `SCSBasic.ini`

All keys can be customized by editing the `SCSBasic.ini` file located in `Grand Theft Auto V\scripts\`

### File Structure:

```ini
[Controls]

; Headlights and Lights
KeyHeadlights=H
KeyHazardLights=H
KeyHighBeams=H
UseShiftForHighBeams=true

; Turn Signals
KeyLeftSignal=Q
KeyRightSignal=E

; Engine
KeyToggleEngine=T
UseShiftForEngine=true

; Windows
KeyToggleWindows=Y
UseShiftForWindows=true

; Menu
KeyShowMenu=I
UseShiftForMenu=true
```

### Available Keys:

#### Letters:
```
A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X, Y, Z
```

#### Numbers (use D before the number):
```
D0, D1, D2, D3, D4, D5, D6, D7, D8, D9
```

#### Function Keys:
```
F1, F2, F3, F4, F5, F6, F7, F8, F9, F10, F11, F12
```

#### NumPad:
```
NumPad0, NumPad1, NumPad2, NumPad3, NumPad4, NumPad5, 
NumPad6, NumPad7, NumPad8, NumPad9
```

#### Arrows:
```
Left, Right, Up, Down
```

#### Special:
```
Space, Enter, Tab, Back, Delete, Insert, Home, End, PageUp, PageDown
```

---

## 📝 CONFIGURATION EXAMPLES

### Example 1: Use NumPad for Turn Signals
```ini
KeyLeftSignal=NumPad4
KeyRightSignal=NumPad6
```

### Example 2: Use Arrow Keys
```ini
KeyLeftSignal=Left
KeyRightSignal=Right
```

### Example 3: Remove SHIFT from Everything
```ini
UseShiftForHighBeams=false
UseShiftForEngine=false
UseShiftForWindows=false
UseShiftForMenu=false
```

### Example 4: Menu with F1 (without SHIFT)
```ini
KeyShowMenu=F1
UseShiftForMenu=false
```

### Example 5: Separate Headlight Controls
```ini
KeyHeadlights=H
KeyHazardLights=J
KeyHighBeams=L
UseShiftForHighBeams=false
```

### Example 6: Engine with G (without SHIFT)
```ini
KeyToggleEngine=G
UseShiftForEngine=false
```

---

## 🔍 TROUBLESHOOTING

### Problem: "Config file not found"

**Cause:** The SCSBasic.ini file is not in the correct location

**Solution:**
1. Verify that `SCSBasic.ini` is in `Grand Theft Auto V\scripts\`
2. Make sure it's in the **same location** as `SCSBasic.dll`
3. Check if the file is not `SCSBasic.ini.txt` (Windows may hide extensions)

**How to check file extensions:**
1. Open Explorer
2. Click on "View"
3. Check "File name extensions"

---

### Problem: Mod doesn't load

**Checklist:**
1. ✅ ScriptHookV installed?
2. ✅ ScriptHookVDotNet3 installed?
3. ✅ Files in `scripts/` folder?
4. ✅ Game updated?

**How to diagnose:**
1. Open `ScriptHookV.log` in the GTA V folder
2. Look for errors related to "SCSBasic"
3. Check for error messages

---

### Problem: Keys don't work

**Possible causes:**

1. **Conflict with GTA V:**
   - Rebind Q and E keys in the game (see [Recommended Configuration](#recommended-gta-v-configuration))

2. **Error in .ini:**
   - Check for extra spaces: `KeyLeftSignal=Q` (correct)
   - Don't use: `KeyLeftSignal = Q` (wrong - spaces)

3. **Incorrect key name:**
   - Use `NumPad5` not `numpad5` (case-sensitive)
   - Use `D0` for the number 0, not just `0`

**Solution:**
1. Test with default configuration first
2. Change one key at a time
3. Reload script (Insert → Reload All Scripts)

---

### Problem: Turn signals reversed

**Solution:**
Edit `SCSBasic.ini` and swap:
```ini
KeyLeftSignal=E
KeyRightSignal=Q
```

---

### Problem: Irregular blinking

**Solution:**
The mod uses GTA V's NATIVE system for blinking. If irregular:

1. Test on different vehicles
2. Check game FPS (low FPS may affect)
3. Update GTA V to latest version

---

## ❓ FREQUENTLY ASKED QUESTIONS

### Q: Can I use with other mods?
**A:** Yes! SCSBasic is compatible with most mods. Just make sure there are no key conflicts.

### Q: Does it work online?
**A:** **NO!** ScriptHookV and mods in general **DO NOT work in GTA Online** and may result in a ban. Use only in **Story Mode**.

### Q: How to reload the script without restarting?
**A:** Press **Insert** in-game and select **"Reload All Scripts"**

### Q: Can I change the blink speed?
**A:** No. The mod uses GTA V's native system which already has perfect and realistic timing.

### Q: Does the mod save light states?
**A:** No. When switching vehicles or restarting the game, all lights return to default state (off).

### Q: Why use Q and E for turn signals?
**A:** It's intuitive (Q = left, E = right) and ergonomic. That's why we recommend rebinding GTA V's default functions.

### Q: Can I use with steering wheel/controller?
**A:** The mod only works with keyboard. For wheel/controller, you would need additional software to map buttons to keys.

### Q: How to uninstall?
**A:** 
1. Delete `SCSBasic.dll` from `scripts/` folder
2. Delete `SCSBasic.ini` from `scripts/` folder
3. (Optional) Restore GTA V's Q and E keys

---

## 📞 SUPPORT

### Log Files:
- `ScriptHookV.log` - Main ScriptHookV log
- Located in GTA V root folder

### Useful Information to Report Issues:
1. GTA V version
2. ScriptHookV version
3. ScriptHookVDotNet version
4. Contents of `SCSBasic.ini` file
5. Error messages (if any)

---

## 📄 LICENSE AND CREDITS BY DOGGTA

**Developed for GTA V**  
Requires ScriptHookV and ScriptHookVDotNet3

**Note:** This mod is provided "as is". Use at your own risk.  
Always backup game files before installing mods.

---

## 🎉 ENJOY!

Now you have complete and realistic control of your vehicle in GTA V!

**Have fun!** 🚗💨
